クレジットカード決済 3DS2.0 API一覧

HTTP仕様(.idPass)

HTTP仕様(.json)

Request header
Content-Type: application/x-www-form-urlencoded;charset=windows-31j
Method
POST
Response header
Content-Type: text/plain;charset=windows-31j
Status Code
200:常に200を返却
Request header
Content-Type: application/json;charset=UTF-8
Method
POST
Response header
Content-Type: application/json;charset=UTF-8
Status Code
  • 200:正常時
  • 400:入力パラメータエラー、加盟店設定エラー
  • 500:システムエラー
  • 502:決済エラー
       
    ※以下のエラーコードはhttp200で返却される可能性がございます。
      ・E90010001
      ・E92000001
      ・E92000002
      ・E91099996
      ・E91099997

EntryTran 取引登録

決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
OrderID orderID 必須 半角英数記号27桁
オーダーID

加盟店様が取引を識別するための値

JobCd jobCd 必須
処理区分
  • CHECK:有効性チェック
  • CAPTURE:即時売上
  • AUTH:仮売上
  • SAUTH:簡易オーソリ
ItemCode itemCode 半角数字7桁 固定
商品コード

カード会社との間の契約で使用する商品コードが決められた場合のみ設定
デフォルトは「0000990」になります。

Amount amount 必須 半角数字7桁
利用金額

処理区分が『有効性チェック』の場合は設定不要

Tax tax 半角数字7桁
税送料

利用金額+税送料で1円~9,999,999円設定可能
税送料(日本円)を指定した場合は、利用金額+税送料を支払通貨で換算した値が支払金額となります。

TdFlag tdFlag
3DS利用フラグ
  • 2:行う(3DS2.0を利用)
TdTenantName tdTenantName 半角英数記号25桁
3DS表示店舗名

表示店舗名をEUC-JPでBASE64エンコーディングした値を設定
25Byte以内である必要があります。
英数半角に設定することを推奨します。
事前にテスト環境で検証してください。
デフォルト値は管理画面から設定できます。
パラメータ未指定かつデフォルト値未設定の場合は「未指定」になります。

※3Dセキュア利用時は設定してください。未設定の場合、カード会社より設定を要請されることがあります。その際は速やかにご対応をお願いいたします。 ご対応いただけない場合には、加盟店契約の解除を求められる可能性がございます。

Tds2Type tds2Type
3DS2.0未対応時取り扱い

仕向先カード会社が3DS2.0に未対応な場合の後続処理設定

  • 1:3DS1.0での認証を実施(デフォルト)
  • 2:エラーとして処理終了
  • 3:通常オーソリを実施
  • 3DS1.0認証サポート終了のため、1以外を指定してください。
    1を指定した場合、ショップの「3DS1.0認証(サポート終了)の取り扱い」の設定に従います。

TdRequired tdRequired
決済時3DS必須タイプ
  • 0:契約内容に従う(デフォルト)
  • 1:3DS認証必須
  • 2:3DS認証必須ではない

URL
/payment/EntryTran.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "orderID":"ORDER0000001",
    "jobCd":"AUTH",
    "amount":"1000"
}
URL
/payment/EntryTran.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&JobCd=AUTH&Amount=1000
レスポンス
正常
AccessID accessID 半角英数32桁 固定
取引ID
AccessPass accessPass 半角英数32桁 固定
取引パスワード
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
    "accessID"="a6a6b0061347e90cdef806b39bd28705",
    "accessPass"="5e0e54b892e14ed03e8cf807a6053813"
}
レスポンスパラメータ:正常系
AccessID=acdc7d53f7a78f488d8d0997eff99c6f&AccessPass=8edc86b5c8b34e92a224f577dec63990
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

ExecTran 決済実行

カード会社と通信を行い決済をします。
3DS2.0にカード会社が未対応の場合は、取引登録時に指定されたTds2Typeの値により対応します。
パラメータに設定する「カード会員」情報については、当サービスではなく加盟店様にて管理している会員の情報になります。
カード会員情報はリスクベース認証に利用します。不明な情報については設定不要です。

利用する決済方法を選択し、共通パラメータに加えて、必要なパラメータを設定してください。
他決済方法のパラメータを指定した場合、想定外の決済方法で処理されることがございますのでご注意ください。

  • トークンを利用して決済する場合

    トークン発行後、呼び出してください。

  • 会員ID決済する場合

    会員ID/カード登録後、呼び出してください。

  • カード番号を利用して決済する場合

    カード番号の取り扱いが許可された加盟店様のみ利用可能です。トークンとカード番号・有効期限・セキュリティコード・名義人を併せて指定するとトークンが優先されます。

    カード番号の取り扱いが許可されていない加盟店様については、パラメータを指定した場合はE61040001エラーが発生します。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

【取引登録】で発行された値を設定します。

OrderID orderID 必須 半角英数記号27桁
オーダーID

【取引登録】で指定した値を設定します。

Method method 必須
支払方法
  • 1:一括
  • 2:分割
  • 3:ボーナス一括
  • 5:リボ

処理区分が「有効性チェック」の場合は設定不要

PayTimes payTimes 半角数字2桁
支払回数

支払方法が「分割」の場合は必須

PIN pin 半角数字4桁
暗証番号

クレジットカードの暗証番号
ご契約時に暗証番号利用を設定された加盟店様のみご利用可能、必須

ClientField1 clientField1 全半角100バイト
加盟店自由項目1
ClientField2 clientField2 全半角100バイト
加盟店自由項目2
ClientField3 clientField3 全半角100バイト
加盟店自由項目3
ClientFieldFlag clientFieldFlag
加盟店自由項目返却フラグ
  • 0:返却しない (デフォルト)
  • 1:返却する
トークンを使用する場合

各パラメータはトークン利用のみ設定してください。

TokenType tokenType
トークンタイプ

カード情報トークンタイプ
トークンを利用して決済する場合設定します。

Token token 必須 半角英数64桁
トークン

トークンタイプ「1」の場合
MPクレカトークン
セキュリティ強度の見直しにより、桁数等が変更される可能性があります。
(※セキュリティ強度の見直しにより変更される可能性があります)

トークンタイプ「2」の場合
Google Pay APIで取得したPayment token
Payment tokenをBASE64エンコードして設定してください。
トークンの作成方法はGoogle Pay APIで取得したPayment tokenの指定方法(Android版)を参照ください。

会員IDを使用する場合

下記パラメータは会員ID利用のみ設定してください。

SiteID siteID 必須 半角英数13桁
サイトID
SitePass sitePass 必須 半角英数10桁
サイトパスワード
MemberID memberID 必須 半角英数記号60桁
会員ID
SeqMode seqMode
カード登録連番モード
  • 0:論理モード(デフォルト)
  • 1:物理モード
    物理モードの場合、削除カードでの決済が可能です。
CardSeq cardSeq 必須 半角数字4桁
カード登録連番
CardPass cardPass 半角英数20桁
カードパスワード

カード登録時に設定したパスワード
カード登録時にCardPassをセットした会員IDを利用して決済する場合は必須です。

SecurityCode securityCode 半角数字4桁
セキュリティーコード

カードに記載されている3桁もしくは4桁の数字

カード番号を使用する場合

下記パラメータはカード番号利用のみ設定してください。

CardNo cardNo 必須 半角数字16桁
クレジットカード番号
Expire expire 必須 半角数字4桁 固定
有効期限

クレジットカードの有効期限
YYMM形式

HolderName holderName 半角英数記号50桁
名義人

クレジットカードの名義

SecurityCode securityCode 半角数字4桁
セキュリティコード

カードに記載されている3桁もしくは4桁の数字

3DS2.0利用パラメータ

下記パラメータは3DS2.0利用時に設定してください。

AppMode appMode
モバイルアプリモード

3DS2.0用のモバイルアプリSDKを利用する場合にのみ指定します。

  • 0:利用しない(デフォルト)
  • 1:利用する

SDKの組み込みは検知精度の向上が期待される一方で、加盟店様の開発コストは一般的に大幅に増加します。
詳細な情報をご希望のお客様は当社営業担当にご相談ください。

RetUrl retUrl 必須 半角英数記号256桁
加盟店戻りURL

3Dセキュア認証後にお戻しする加盟店様側のURLになります。
通常は必ず指定してください。モバイルアプリSDKを利用する場合は設定不要です。
URLに遷移するHTTPメソッド(GET/POST)は、CallbackTypeパラメータで切り替えることができます。

Tds2ChallengeIndType tds2ChallengeIndType
3DS2.0認証チャレンジ要求タイプ

リスク判定の結果によらず3Dセキュア認証チャレンジを要求する場合に指定します。

  • 1:認証必須
     低リスク時もチャレンジ認証を要求いたします。
    ※認証チャレンジとなるかは、カード発行会社の判断となり、認証チャレンジに進むことを保証するものではございません。 
  • 2:認証必須ではない
     低リスク時はチャレンジ認証を要求しません。 
CallbackType callbackType
コールバック方法

加盟店様が指定した戻りURLに当社から戻す方式を指定します。
通常は「1」(POST方式)または「3」(GET方式)を設定してください。モバイルアプリSDKを利用する場合は設定不要です。

  • 1:通常(POST方式)(デフォルト)
  • 2:直接受ける
  • 3:通常(GET方式)

「1」または「3」の場合、認証後のコールバック一回のみで済みます。(決済フローの「通常コールバック方式」参照)
「2」を指定すると認証初期化後、チャレンジ後の最大二回のコールバックが発生し、加えて以下のAPIを呼び出す必要があります。こちらの方式では加盟店様側で認証結果を取得できるので認証エラーの場合はオーソリを行わないようにする等、決済フローの制御が可能になります。(決済フローの「都度加盟店コールバック方式」参照)

Tds2ChAccChange tds2ChAccChange 半角数字8桁 固定
会員最終更新日

加盟店サイト上のこの会員の情報が更新された日付を設定します。決済用カード情報の追加や配送先住所の変更がされた日付を想定しています。
新規登録された会員の場合は登録日を設定してください。
更新された日付が不明な場合は未設定で構いません
YYYYMMDD形式です。

Tds2ChAccDate tds2ChAccDate 半角数字8桁 固定
会員作成日

加盟店サイト上にてこの会員が新規登録された日付を設定します。クレジットカード番号を登録した日ではありません。
ゲストとして取引を行う場合は未設定で構いません。
YYYYMMDD形式です。

Tds2ChAccPwChange tds2ChAccPwChange 半角数字8桁 固定
会員パスワード変更日

加盟店サイト上のこの会員のログインパスワードが変更された日付を設定します。
パスワード忘れなどでリセットした場合も含まれます。
ゲストとして取引を行っている場合、またはパスワードを変更したことが無い場合は未設定で構いません。
YYYYMMDD形式です。

Tds2NbPurchaseAccount tds2NbPurchaseAccount 半角数字4桁
過去6ヶ月間の購入回数

加盟店サイト上にて過去6ヵ月間にこの会員がクレジットカード決済で決済成功して購入完了に至った回数を設定します。
対象期間の開始日について、処理日が8/20であれば3/1以降としても良いですし、処理日時点の180日前以降としても問題ありません。

Tds2PaymentAccAge tds2PaymentAccAge 半角数字8桁 固定
カード登録日

加盟店サイト上のこの会員が今回の決済で利用するカード情報を登録した日付を設定します。
未設定の場合、当社で会員登録日を自動で設定します。
都度カード番号を入力する場合は未設定で構いません。

Tds2ProvisionAttemptsDay tds2ProvisionAttemptsDay 半角数字3桁
過去24時間のカード追加試行回数

加盟店サイト上のこの会員が、過去24時間以内にカード情報を登録した試行回数を設定します。
複数種類のカードで試して失敗した回数も含めていただきます。しかし成功した回数しか分からない場合は成功回数だけで構いません。

Tds2ShipAddressUsage tds2ShipAddressUsage 半角数字8桁 固定
配送先住所の初回使用日

この取引での指定された配送先住所が、初めて利用された日付を設定します。過去の実績はクレジットカード決済で行われたかは問いません。
加盟店サイトにて記録されている最も古い取引時の日付で構いません。
会員登録なしでの取引、配送が発生しない場合は未設定で構いません。
YYYYMMDD形式です。

Tds2ShipNameInd tds2ShipNameInd
カード会員名と配送先名の一致/不一致

この取引でのクレジットカード番号の会員名と配送先情報の宛名が一致しているかを指定します。

  • 01:カード会員名と配送先名が一致
  • 02:カード会員名と配送先名が不一致

配送が発生しない場合や配送先の宛名が不明の場合は未設定で構いません。

Tds2SuspiciousAccActivity tds2SuspiciousAccActivity
不審行為情報

今回の取引に限らずこの会員が加盟店サイト上にて不審な行動をしているかどうかを指定します。

  • 01:不審な行動は見られなかった
  • 02:不審な行動が見られた

不明、または判断が困難な場合は未設定で構いません。
過去に不正利用をしている、一般的には発生しない操作が記録されているなどの場合に設定してください。

Tds2TxnActivityDay tds2TxnActivityDay 半角数字3桁
過去24時間の取引回数

加盟店サイト上のこの会員が、過去24時間以内に取引を行った回数を設定します。
クレジットカード決済で行われたか、決済に成功したかは問いません。
回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。

Tds2TxnActivityYear tds2TxnActivityYear 半角数字3桁
過去1年の取引回数

加盟店サイト上のこの会員が、過去1年以内に取引を行った回数を設定します。
クレジットカード決済で行われたか、決済に成功したかは問いません。
対象とする期間は厳密に過去1年とする必要はありません。処理日が2022年10月10日の場合、2021年9月~2022年9月や2021年10月10日~2022年10月9日、または直近365日としても問題ありません。また1年分の履歴を保持していない場合、可能な範囲での算出で構いません。
回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。

Tds2ThreeDSReqAuthTimestamp tds2ThreeDSReqAuthTimestamp 半角数字12桁 固定
ログイン日時

この会員が加盟店サイトにログインした日時を設定します。
ゲストとしてログインしている場合は未設定で構いません。
YYYYMMDDHHMM形式です。

Tds2ThreeDSReqAuthMethod tds2ThreeDSReqAuthMethod
ログイン方法

この会員が加盟店サイトへのログイン時に認証した方法を指定します。

  • 01:認証なし、ゲストログイン
  • 02:加盟店サイト自身の認証情報
  • 03:フェデレーションIDを利用した認証
  • 04:イシュアの認証情報
      カード会社が提供しているポイントサイトなどのログイン認証などで認証済みとしている場合
  • 05:サードパーティ認証
      Facebook、Googleなど他サービスの認証を利用
Tds2ThreeDSReqAuthData tds2ThreeDSReqAuthData 全半角2048バイト
ログイン証跡データ

「ログイン方法(Tds2ThreeDSReqAuthMethod)」に、"03" を指定した場合にフェデレーションIDのプロバイダーに関する情報と関連情報を設定します。
それ以外を指定している場合は未設定で構いません。

Tds2AddrMatch tds2AddrMatch
請求先住所と配送先住所の一致/不一致

この取引での請求先住所と配送先情報が一致しているかを指定します。

  • Y:一致
  • N:不一致

配送が発生しない場合や判断ができない場合は未設定で構いません。
コンビニ受け取りのような場合は不一致としてください。

Tds2BillAddrCity tds2BillAddrCity 全半角50桁
請求先住所の市区町村

この取引での請求先住所の「市区町村」を設定します。

例として「渋谷区」「横浜市」となります。

日本語漢字でなくても構いません。
請求先住所情報を保持していない場合は未設定で構いません。

Tds2BillAddrCountry tds2BillAddrCountry 半角数字3桁 固定
請求先住所の国番号

この取引での請求先住所の「国番号」を設定します。
設定する番号はISO3166-1の数字3桁となります。
ITU-E.164ではないのでご注意ください。

例として日本の場合は「392」です。

請求先住所情報を保持していない場合は未設定で構いません。

Tds2BillAddrLine1 tds2BillAddrLine1 全半角50桁
請求先住所の町域・丁目番地

この取引での請求先住所の「町域・丁目番地」を設定します。
請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。
保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2BillAddrLine1~Tds2BillAddrLine3に住所を設定してください。Tds2BillAddrLine1にすべて収まる場合は、Tds2BillAddrLine2とTds2BillAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。

Tds2BillAddrLine2 tds2BillAddrLine2 全半角50桁
請求先住所の建物・号室

この取引での請求先住所の「建物・号室」を設定します。
請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。

Tds2BillAddrLine3 tds2BillAddrLine3 全半角50桁
請求先住所情報の予備項目

請求先住所情報に関する予備項目です。
設定は不要です。

Tds2BillAddrPostCode tds2BillAddrPostCode 半角英数16桁
請求先住所の郵便番号

この取引での請求先住所の「郵便番号」を設定します。
ハイフンは含めても、含まなくてもどちらでも構いません。
請求先住所情報を保持していない場合は未設定で構いません。

Tds2BillAddrState tds2BillAddrState 半角英数3桁
請求先住所の都道府県番号

この取引での請求先住所の「都道府県番号」を設定します。
こちらの都道府県コード表を参照してください。
https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf

「01」~「47」からなる先頭ゼロ埋めの2桁の形式です。
請求先住所情報を保持していない場合は未設定で構いません。

Tds2Email tds2Email 半角英数記号254桁
メールアドレス

この会員の電子メールアドレスを設定します。
「RFC 5322」の仕様に沿った形式のみ許可されます。
2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。
メールアドレスを保持していない場合は未設定で構いません。

Tds2HomePhoneCC tds2HomePhoneCC 半角数字3桁
自宅電話の国コード

この会員の自宅電話の「国コード」を設定します。
設定する国コードはITU-E.164の1~3桁の数字となります。
ISO3166-1ではないのでご注意ください。

例として日本の場合は「81」です。
プラス記号(+)はつけないでください。

Tds2HomePhoneSubscriber tds2HomePhoneSubscriber 半角数字15桁
自宅電話番号

この会員の自宅電話番号を設定します。
先頭一桁目のゼロは不要です。

例として東京都の場合は「312345678」です。
自宅電話として携帯電話が登録されている場合は携帯電話番号を設定してください。

Tds2MobilePhoneCC tds2MobilePhoneCC 半角数字3桁
携帯電話の国コード

この会員の携帯電話の「国コード」を設定します。
設定する国コードはITU-E.164の1~3桁の数字となります。
ISO3166-1ではないのでご注意ください。

例として日本の場合は「81」です。
プラス記号(+)はつけないでください。

Tds2MobilePhoneSubscriber tds2MobilePhoneSubscriber 半角数字15桁
携帯電話番号

この会員の携帯電話番号を設定します。
先頭一桁目のゼロは不要です。

例として「9012345678」です。

Tds2WorkPhoneCC tds2WorkPhoneCC 半角数字3桁
職場電話の国コード

この会員の職場電話の「国コード」を設定します。
設定する国コードはITU-E.164の1~3桁の数字となります。
ISO3166-1ではないのでご注意ください。

例として日本の場合は「81」です。
プラス記号(+)はつけないでください。

職場電話情報が無い場合は未設定で構いません。

Tds2WorkPhoneSubscriber tds2WorkPhoneSubscriber 半角数字15桁
職場電話番号

この会員の職場電話番号を設定します。
先頭一桁目のゼロは不要です。

例として東京都の場合は「312345678」です。
職場電話情報が無い場合は未設定で構いません。

Tds2ShipAddrCity tds2ShipAddrCity 全半角50桁
配送先住所の市区町村

この取引での配送先住所の「市区町村」を設定します。

例として「渋谷区」「横浜市」となります。

日本語漢字でなくても構いません。
配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。

Tds2ShipAddrCountry tds2ShipAddrCountry 半角数字3桁 固定
配送先住所の国番号

この取引での配送先住所の「国番号」を設定します。
設定する番号はISO3166-1の数字3桁となります。
ITU-E.164ではないのでご注意ください。

例として日本の場合は「392」です。

配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。

Tds2ShipAddrLine1 tds2ShipAddrLine1 全半角50桁
配送先住所の町域・丁目番地

この取引での配送先住所の「町域・丁目番地」を設定します。
配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。

保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2ShipAddrLine1~Tds2ShipAddrLine3に住所を設定してください。Tds2ShipAddrLine1にすべて収まる場合は、Tds2ShipAddrLine2とTds2ShipAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。

Tds2ShipAddrLine2 tds2ShipAddrLine2 全半角50桁
配送先住所の建物・号室

この取引での配送先住所の「建物・号室」を設定します。
配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。

Tds2ShipAddrLine3 tds2ShipAddrLine3 全半角50桁
配送先住所情報の予備項目

配送先住所情報に関する予備項目です。
設定は不要です。

Tds2ShipAddrPostCode tds2ShipAddrPostCode 半角英数16桁
配送先住所の郵便番号

この取引での配送先住所の「郵便番号」を設定します。
ハイフンは含めても、含まなくてもどちらでも構いません。
配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。

Tds2ShipAddrState tds2ShipAddrState 半角英数3桁
配送先住所の都道府県

この取引での配送先住所の「都道府県番号」を設定します。
こちらの都道府県コード表を参照してください。
https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf

「01」~「47」からなる先頭ゼロ埋めの2桁の形式です。
配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。

Tds2DeliveryEmailAddress tds2DeliveryEmailAddress 半角英数記号254桁
電子配送時の配送先メールアドレス

この取引内容がWebチケットなどの電子デリバリーの場合に、配信先の電子メールアドレスを設定します。
「RFC 5322」の仕様に沿った形式のみ許可されます。
2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。
電子デリバリーではない場合は未設定で構いません。

Tds2DeliveryTimeframe tds2DeliveryTimeframe
商品出荷の時間枠

商品納品時間枠を指定します。

  • 01:電子デリバリー、商品の出荷が発生しない
  • 02:当日出荷
  • 03:翌日出荷
  • 04:2日目以降の出荷
Tds2GiftCardAmount tds2GiftCardAmount 半角数字15桁
プリペイドカード/ギフトカード購入の総金額

この取引がプリペイドカードまたはギフトカード購入の場合、購入した総金額を設定します。

Tds2GiftCardCount tds2GiftCardCount 半角数字2桁
プリペイドカード/ギフトカード購入の総件数

この取引がプリペイドカードまたはギフトカード購入の場合、購入した総枚数を設定します。

Tds2GiftCardCurr tds2GiftCardCurr 半角数字3桁 固定
プリペイドカード/ギフトカード購入の通貨コード

この取引がプリペイドカードまたはギフトカード購入の場合、購入の通貨コードを設定します。
設定する番号はISO 4217の数字3桁となります。
ITU-E.164ではないのでご注意ください。

例として日本円の場合は「392」です。

Tds2PreOrderDate tds2PreOrderDate 半角数字8桁 固定
予約販売の発売予定日

この取引が先行予約販売による決済の場合に、商品の発売予定日を設定します。
YYYYMMDD 形式です。
発売予定日が不明の場合は未設定で構いません。

Tds2PreOrderPurchaseInd tds2PreOrderPurchaseInd
予約販売の商品有無

この取引が先行予約販売による決済の場合に、商品が現時点で存在するかどうかを指定します。

  • 01:商品がある
  • 02:予約の商品、まだ存在しない
Tds2ReorderItemsInd tds2ReorderItemsInd
再購入情報

この会員が取引対象の商品の以前も購入したことがあるかを指定します。

  • 01:新規購入
  • 02:再購入

判別が困難な場合は未設定で構いません。
新規と再購入が混在している場合は、新規購入として設定してください。

Tds2ShipInd tds2ShipInd
商品配送方法

この取引での商品の配送方法を設定します。

  • 01:カード会員の請求先住所に配送する
  • 02:加盟店様が保持している別の確認済み住所に配送する
  • 03:カード会員の請求先住所と異なる住所に配送する
  • 04:店舗へ配送/近所の店舗での受け取りであり店舗の住所は配送先住所で指定する
  • 05:デジタル商品、オンラインサービス、電子ギフトカードおよび償還コードを含む
  • 06:配送なし、旅行およびイベントのチケットなど
  • 07:その他、ゲーム、配送されないデジタルサービス、電子メディアの購読料など

URL
/payment/ExecTran.json
リクエストパラメータ:トークン利用
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "method":"1",
    "token":"Lg9sRgo5nx6yfefJ51z8bj/1VdNFAaCZYWZ+qLKJyqWwBS7yYvxSiC0zeMVH+O4F"
}
リクエストパラメータ:会員ID利用
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "siteID":"tsite99887814",
    "method":"1",
    "sitePass":"PASSWORD",
    "memberID":"Member00",
    "cardSeq":"1",
    "cardPass":"PassWord"
}
リクエストパラメータ:カード番号利用
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "method":"1",
    "cardNo":"4111111111111111",
    "expire":"2512"
}
URL
/payment/ExecTran.idPass
リクエストパラメータ:トークン利用
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&Method=1&Token=Lg9sRgo5nx6yfefJ51z8bj/1VdNFAaCZYWZ+qLKJyqWwBS7yYvxSiC0zeMVH+O4F
リクエストパラメータ:会員ID利用
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&Method=1&SiteID=tsite99887814&SitePass=PASSWORD&MemberID=Member00&CardSeq=1&CardPass=PassWord
リクエストパラメータ:カード番号利用
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&Method=1&CardNo=4111111111111111&Expire=2512
レスポンス
正常
ACS acs
ACS呼出判定
  • 2:ACS呼出要(3DS2.0)
RedirectUrl redirectUrl
3DSサーバーへのリダイレクトURL

3DS2.0認証初期化へのURL(※1)

リダイレクト先ドメイン
テスト環境:pt01.mul-pay.jp
本番環境:manage.tds2gw.gmopg.jp

※1:値に"&"や"="が含まれます。idPass版をご利用の場合は文字列のパースにご注意ください。
※2:レスポンスパラメータの順序は固定ですのでご注意ください。
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrorInfo errorInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
    "acs":"2",
    "redirectUrl":"https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a"
}
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:正常系
ACS=2&RedirectUrl=https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a
(※2)
レスポンスパラメータ:異常系
ErrCode=M01&ErrInfo=M01470008

カード会社の3DS2.0画面を呼び出す

この部分は当サービスではなく、お客様と3DSサービスのやりとりとなりますので、加盟店様は当サービスより返却したRedirectUrlにお客様を誘導します。
RedirectUrlはHTTPメソッド GETで遷移しますので、以下のリダイレクトHTTPヘッダ、またはリダイレクトページのサンプルを参考に呼び出してください。
3DS2.0ではカード会社側の判定によりパスワード入力画面が不要となる場合がございます。

リクエスト
RedirectUrl 必須
3DS2.0開始 URL

【決済実行】で発行された値

リダイレクトHTTPヘッダサンプル
HTTP/1.1 302 Found
Location: {RedirectUrl}
リダイレクトページサンプル
<html>
 <head>
  <meta http-equiv="refresh" content="0; URL={RedirectUrl}" />
 </head>
</html>
レスポンス(当サービス⇒加盟店様)

【決済実行】で設定されたRetUrlに、本サービスより以下パラメータを送信します。

正常
AccessID 半角英数32桁 固定
取引ID

【取引登録】で発行された値

3DS2.0サーバーからのコールバック

【決済実行】で設定されたRetUrlで3DSサーバーからのコールバックを受けることができます。

コールバックは下記のタイミングで行われます。

  • 加盟店様が3DS2.0開始URL(RedirectUrl)に誘導し(リダイレクトするように仕向け)、3DSサーバーの3DS2.0認証初期化が完了した後
  • 加盟店様が3DS2.0認証チャレンジURL(ChallengeUrl)に誘導し(リダイレクトするように仕向け)、カード所有者による本人認証が完了した後

3DSサーバーからのコールバックを直接受けるには、【決済実行】のコールバック方法に「2:直接受ける」を設定する必要があります。
コールバックのHTTP Method はPOSTです。

コールバックパラメータ(3DS⇒加盟店様)
正常
MD 半角英数32桁 固定
取引ID

【取引登録】で発行された値
この値はURLクエリパラメータに設定されます。

requestorTransId
リクエスター取引ID

(この値は使いません)

event
イベント

  • 3DSMethodFinished:3DS2.0初期化処理が完了しました。3DS2.0認証処理を実行してください。
  • 3DSMethodSkipped:3DS2.0初期化処理をスキップした。3DS2.0認証処理を実行してください。
  • AuthResultReady:3DS2.0認証結果取得の準備が完了しました。

param 半角英数2000桁
3DS2.0認証パラメータ

3DSサーバーが設定するPOSTパラメータ
この値は3DS2.0認証実行で必要になります。

Tds2Auth 3DS2.0認証実行

3DS2.0認証を実行します。
3DS2.0認証初期化URL(RedirectUrl)のコールバックを受けたタイミングで本処理を実行してください。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID
AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード
Tds2Param tds2Param 必須 半角英数記号2000桁
3DS2.0認証パラメータ

加盟店様が取引を識別するための値

URL
/payment/Tds2Auth.json
リクエストパラメータ
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "tds2Param":"eyJicm93c2VyQWNjZXB0SGVhZGVyIjoidGV4dC9odG1sLGFwcGxpY2F0aW9uL3hodG1sK3htbCxhcHBsaWNhdGlvbi94bWw7cT0wLjksKi8qO3E9MC44IiwiYnJvd3NlcklQIjoiMTkyLjE2OC4xLjExIiwiYnJvd3NlckphdmFFbmFibGVkIjpmYWxzZSwiYnJvd3Nlckxhbmd1YWdlIjoiZW4iLCJicm93c2VyQ29sb3JEZXB0aCI6IjQ4IiwiYnJvd3NlclNjcmVlbkhlaWdodCI6IjQwMCIsImJyb3dzZXJTY3JlZW5XaWR0aCI6IjYwMCIsImJyb3dzZXJUWiI6IjAiLCJicm93c2VyVXNlckFnZW50IjoiTW96aWxsYS81LjAgKFdpbmRvd3MgTlQgNi4xOyBXaW42NDsgeDY0OyBydjo0Ny4wKSBHZWNrby8yMDEwMDEwMSBGaXJlZm94LzQ3LjAifQ"
}
URL
/payment/Tds2Auth.idPass
リクエストパラメータ
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&Tds2Param=eyJicm93c2VyQWNjZXB0SGVhZGVyIjoidGV4dC9odG1sLGFwcGxpY2F0aW9uL3hodG1sK3htbCxhcHBsaWNhdGlvbi94bWw7cT0wLjksKi8qO3E9MC44IiwiYnJvd3NlcklQIjoiMTkyLjE2OC4xLjExIiwiYnJvd3NlckphdmFFbmFibGVkIjpmYWxzZSwiYnJvd3Nlckxhbmd1YWdlIjoiZW4iLCJicm93c2VyQ29sb3JEZXB0aCI6IjQ4IiwiYnJvd3NlclNjcmVlbkhlaWdodCI6IjQwMCIsImJyb3dzZXJTY3JlZW5XaWR0aCI6IjYwMCIsImJyb3dzZXJUWiI6IjAiLCJicm93c2VyVXNlckFnZW50IjoiTW96aWxsYS81LjAgKFdpbmRvd3MgTlQgNi4xOyBXaW42NDsgeDY0OyBydjo0Ny4wKSBHZWNrby8yMDEwMDEwMSBGaXJlZm94LzQ3LjAifQ
レスポンス

【決済実行】で設定されたRetUrlに、当サービスより以下パラメータを送信します。
認証結果に応じて認証フローを制御する必要があります。
・「Y:認証/口座確認に成功」または「A:処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「C:認証チャレンジが必要」の場合、3DS2.0認証チャレンジURLにリダイレクトしてください。リダイレクトは3DS2.0開始URL(RedirectUrl)のリダイレクトサンプルを参照ください。
・「N:未認証/口座未確認。取引拒否」または「U:認証/口座確認を実行できなかった」、「R:認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常
Tds2TransResult tds2TransResult 半角英数1桁 固定
認証結果
  • Y:認証/口座確認に成功
  • A:処理の試行が実施された
  • C:認証チャレンジが必要
  • N:未認証/口座未確認。取引拒否
  • U:認証/口座確認を実行できなかった
  • R:認証/口座確認が拒否された
Tds2TransResultReason tds2TransResultReason 半角英数2桁 固定
認証結果理由
  • 01:カード認証に失敗した
  • 02:不明なデバイス
  • 03:サポートされていないデバイス
  • 04:認証頻度の上限を超えた
  • 05:有効期限切れのカード
  • 06:無効なカード番号
  • 07:無効な取引
  • 08:カードのレコードが存在しない
  • 09:セキュリティ障害
  • 10:盗難カード
  • 11:不正の疑い
  • 12:カード会員に取引が許可されていない
  • 13:カード会員がサービスに登録されていない
  • 14:取引がACSでタイムアウトした
  • 15:信頼度が低い
  • 16:信頼度が中程度
  • 17:信頼度が高い
  • 18:信頼度が非常に高い
  • 19:ACSの最大チャレンジを超える
  • 20:非決済取引はサポートされていません
  • 21:3RIトランザクションはサポートされていません
  • 22:ACSの技術的な問題
  • 26:認証は試行されましたが、カード会員によって実行されませんでした
  • 80-99:DS(ディレクトリサーバ ー)の利用枠
ChallengeUrl challengeUrl 半角英数256桁 固定
3DS2.0認証チャレンジURL

認証結果が「C:チャレンジ」の場合に返却します。

レスポンスパラメータ:正常系
{
    "tds2TransResult":"C",
    "challengeUrl":"https://manage.tds2gw.gmopg.jp/api/v2/auth/brw?t=40a251d4459925fd6bc35db58ab6ebe3"
}
レスポンスパラメータ:正常系
Tds2TransResult=C&ChallengeUrl=https://manage.tds2gw.gmopg.jp/api/v2/auth/brw?t=40a251d4459925fd6bc35db58ab6ebe3

Tds2Result 3DS2.0認証結果取得

3DS2.0認証の最終的な認証結果を取得します。
3DS2.0認証チャレンジURL(ChallengeUrl)のコールバックを受けたタイミングで本処理を実行してください。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

【取引登録】で発行された値を設定します。

URL
/payment/Tds2Result.json
リクエストパラメータ
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de"
}
URL
/payment/Tds2Result.idPass
リクエストパラメータ
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de
レスポンス

【決済実行】で設定されたRetUrlに、本サービスより以下パラメータを送信します。
認証結果に応じて認証フローを制御する必要があります。

・「Y:認証/口座確認に成功」または「A:処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「N:未認証/口座未確認。取引拒否」または「U:認証/口座確認を実行できなかった」、「R:認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常
Tds2TransResult tds2TransResult 半角英数1桁 固定
認証結果
  • Y:認証/口座確認に成功
  • A:処理の試行が実施された
  • N:未認証/口座未確認。取引拒否
  • U:認証/口座確認を実行できなかった
  • R:認証 / 口座確認が拒否された
Tds2TransResultReason tds2TransResultReason 半角英数2桁 固定
認証結果理由
  • 01:カード認証に失敗した
  • 02:不明なデバイス
  • 03:サポートされていないデバイス
  • 04:認証頻度の上限を超えた
  • 05:有効期限切れのカード
  • 06:無効なカード番号
  • 07:無効な取引
  • 08:カードのレコードが存在しない
  • 09:セキュリティ障害
  • 10:盗難カード
  • 11:不正の疑い
  • 12:カード会員に取引が許可されていない
  • 13:カード会員がサービスに登録されていない
  • 14:取引がACSでタイムアウトした
  • 15:信頼度が低い
  • 16:信頼度が中程度
  • 17:信頼度が高い
  • 18:信頼度が非常に高い
  • 19:ACSの最大チャレンジを超える
  • 20:非決済取引はサポートされていません
  • 21:3RIトランザクションはサポートされていません
  • 22:ACSの技術的な問題
  • 26:認証は試行されましたが、カード会員によって実行されませんでした
  • 80-99:DS(ディレクトリサーバ ー)の利用枠
レスポンスパラメータ:正常系
{
    "tds2TransResult":"Y",
    "tds2TransResultReason":"18"
}
レスポンスパラメータ:正常系
Tds2TransResult=Y&Tds2TransResultReason=18

Tds2AuthApp 3DS2.0認証実行

3DS2.0認証を実行します。
本APIはモバイルアプリに組み込むため、3DS SDKをお使いの場合にご利用頂けます。
JWKについては用語集をご確認ください。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

【取引登録】で発行された値を設定します。

Tds2SdkInterface tds2SdkInterface 半角数字2桁
3DS SDK インタフェース
  • 01:ネイティブ
  • 02:HTML
  • 03:両方
Tds2SdkAppID tds2SdkAppID 必須 半角英数記号36桁
アプリID
Tds2EncData tds2EncData 必須 半角英数記号64000桁
3DS2.0暗号化データ
Tds2SdkJwk tds2SdkJwk 必須 半角英字3桁
3DS2.0 JWS キータイプ

RSA や EC といった暗号アルゴリズムファミリーを示します。以下より選択できます。
[ EC, RSA, OCT ]

Tds2SdkMaxTimeout tds2SdkMaxTimeout 必須 半角数字2桁
最大タイムアウト

すべてのデータ交換に費やされる最大時間(分単位)を示します。

Tds2SdkReferenceNumber tds2SdkReferenceNumber 必須 半角英数記号32桁
リファレンス番号

3DS SDKが承認されたときにEMVCoによって割り当てられ、モバイルアプリに統合される3DS SDKのベンダーとバージョンを識別します。

Tds2SdkTransID tds2SdkTransID 必須 半角英数記号36桁
SDK取引ID

単一の取引を識別するために3DS SDKによって割り当てられる一意なUUID。

URL
/payment/Tds2AuthApp.json
リクエストパラメータ
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "tds2SdkAppID":"dbd64fcb-c19a-4728-8849-e3d50bfdde39",
    "tds2EncData":"eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMTI4Q0JDLUhTMjU2In0.ccQZYGCLukkC6VTnmtLK38E7Gn9MCdLHtURqQEHssce9fCvSepSkRT5bm8CmeA4xkDoL_acJMK2SHprM4ACN_c2q0yNZLIKfViDi2xQJcPdw_B1t6JGdC8DnHeRztbQV1Bb12MM-9Tx_bPFdjt3anvB4LTTlXaSbhYuq1Mz4XqlPn_2uSvL2yWoo28c_fI2iko9MK_0ve6ic3RCn6zY8EPr5zM9wtglXJCqzxakI0r0CpbERBcPsuOKFlTMkbNaIuIXwjHqrW7hPhaVzHuJae8XaFwUjhqdzFl4CX7D7FZSxN1dQKwhYQSAvIY0hxoedYMiH0wUOPseIHJOqDpgF9A.HdOq09yjVFCLC7s8Z80fHw.fkeoW3iHv7pdK3S2oWa6CbmyWfCrGqrz9q6Dui6k3Yz6kqImmJG_DsTk5lyXP1xLYedvwUqXtGp0kez91SyKlt4U52IVB-8_Ot0INxsyILu0G-QMbwgdxrRmOIzpUHAgmkdwQle-WHIDF6CNrQySDSbzPzGIZ5Nve4gZszVL4QzDyV06aKUlL4gIETYTYmojMnmmz6tOnhercgpv2AL0DWMTmdnRq2pG0QD7UOX0JQKEYitLOlzuttJHNsMs61rtgalHlquoEDKx27bzbJEq6G4iY8gUR9oehDjHg4gBpC8N0JsNoIJTY08VFQGf8_HRE89AOXjcT8xLwNsU8WYSYHCRNrtMx8CngjXkRUi2dKMhZoM6xkj2Egqkz_n8wec47FSI8GpvrbQmabaxgSglFLW2PWmDEcgXCrJKL4Aup6HwUDWwzm38nd-An8ZnFbk8_FXQued7gfMySGar_JICZg.QHGeYBZQvys7iQhqAYoyZQ",
    "tds2SdkJwk":"EC",
    "tds2SdkMaxTimeout":"05",
    "tds2SdkReferenceNumber":"3DS_GP_SDK_201_67890",
    "tds2SdkTransID":"b2385523-a66c-4907-ac3c-91848e8c0067"
}
URL
/payment/Tds2AuthApp.idPass
リクエストパラメータ
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&Tds2SdkAppID=dbd64fcb-c19a-4728-8849-e3d50bfdde39&Tds2EncData=eyJhbGciOiJSU0EtT0FFUC0yNTYiLCJlbmMiOiJBMTI4Q0JDLUhTMjU2In0.ccQZYGCLukkC6VTnmtLK38E7Gn9MCdLHtURqQEHssce9fCvSepSkRT5bm8CmeA4xkDoL_acJMK2SHprM4ACN_c2q0yNZLIKfViDi2xQJcPdw_B1t6JGdC8DnHeRztbQV1Bb12MM-9Tx_bPFdjt3anvB4LTTlXaSbhYuq1Mz4XqlPn_2uSvL2yWoo28c_fI2iko9MK_0ve6ic3RCn6zY8EPr5zM9wtglXJCqzxakI0r0CpbERBcPsuOKFlTMkbNaIuIXwjHqrW7hPhaVzHuJae8XaFwUjhqdzFl4CX7D7FZSxN1dQKwhYQSAvIY0hxoedYMiH0wUOPseIHJOqDpgF9A.HdOq09yjVFCLC7s8Z80fHw.fkeoW3iHv7pdK3S2oWa6CbmyWfCrGqrz9q6Dui6k3Yz6kqImmJG_DsTk5lyXP1xLYedvwUqXtGp0kez91SyKlt4U52IVB-8_Ot0INxsyILu0G-QMbwgdxrRmOIzpUHAgmkdwQle-WHIDF6CNrQySDSbzPzGIZ5Nve4gZszVL4QzDyV06aKUlL4gIETYTYmojMnmmz6tOnhercgpv2AL0DWMTmdnRq2pG0QD7UOX0JQKEYitLOlzuttJHNsMs61rtgalHlquoEDKx27bzbJEq6G4iY8gUR9oehDjHg4gBpC8N0JsNoIJTY08VFQGf8_HRE89AOXjcT8xLwNsU8WYSYHCRNrtMx8CngjXkRUi2dKMhZoM6xkj2Egqkz_n8wec47FSI8GpvrbQmabaxgSglFLW2PWmDEcgXCrJKL4Aup6HwUDWwzm38nd-An8ZnFbk8_FXQued7gfMySGar_JICZg.QHGeYBZQvys7iQhqAYoyZQ&Tds2SdkJwk=EC&Tds2SdkMaxTimeout=05&Tds2SdkReferenceNumber=3DS_GP_SDK_201_67890&Tds2SdkTransID=b2385523-a66c-4907-ac3c-91848e8c0067
レスポンス

認証結果に応じて認証フローを制御する必要があります。

・「Y:認証/口座確認に成功」または「A:処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「C:認証チャレンジが必要」の場合、3DS2.0認証チャレンジを開始してください。
・「N:未認証/口座未確認。取引拒否」または「U:認証/口座確認を実行できなかった」、「R:認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常
Tds2TransResult tds2TransResult 半角英数1桁 固定
認証結果
  • Y:認証/口座確認に成功
  • A:処理の試行が実施された
  • C:認証チャレンジが必要
  • N:未認証/口座未確認。取引拒否
  • U:認証/口座確認を実行できなかった
  • R:認証/口座確認が拒否された
Tds2TransResultReason tds2TransResultReason 半角英数2桁 固定
認証結果理由
  • 01:カード認証に失敗した
  • 02:不明なデバイス
  • 03:サポートされていないデバイス
  • 04:認証頻度の上限を超えた
  • 05:有効期限切れのカード
  • 06:無効なカード番号
  • 07:無効な取引
  • 08:カードのレコードが存在しない
  • 09:セキュリティ障害
  • 10:盗難カード
  • 11:不正の疑い
  • 12:カード会員に取引が許可されていない
  • 13:カード会員がサービスに登録されていない
  • 14:取引がACSでタイムアウトした
  • 15:信頼度が低い
  • 16:信頼度が中程度
  • 17:信頼度が高い
  • 18:信頼度が非常に高い
  • 19:ACSの最大チャレンジを超える
  • 20:非決済取引はサポートされていません
  • 21:3RIトランザクションはサポートされていません
  • 22:ACSの技術的な問題
  • 26:認証は試行されましたが、カード会員によって実行されませんでした
  • 80-99:DS(ディレクトリサーバ ー)の利用枠
Tds2AcsReferenceNumber tds2AcsReferenceNumber 半角英数記号32桁
ACSリファレンス番号

認証結果が「C:認証チャレンジが必要」の場合に返却されます。

Tds2AcsSignedContent tds2AcsSignedContent 半角英数記号64000桁
ACS署名済みコンテンツ

認証結果が「C:認証チャレンジが必要」の場合に返却されます。

Tds2AcsTransID tds2AcsTransID 半角英数記号36桁
ACS取引ID

認証結果が「C:認証チャレンジが必要」の場合に返却されます。

Tds2DsTransID tds2DsTransID 半角英数記号36桁
DS取引ID

認証結果が「C:認証チャレンジが必要」の場合に返却されます。

Tds2ThreeDSServerTransID tds2ThreeDSServerTransID 半角英数記号36桁
3DSサーバー取引ID

認証結果が「C:認証チャレンジが必要」の場合に返却されます。

レスポンスパラメータ:正常系
{
    "tds2TransResult":"C",
    "tds2AcsReferenceNumber":"3DS_AAA_BBB_NTDC_123456_98765",
    "tds2AcsSignedContent":"eyJkdW1teSI6ImR1bW15In0=",
    "tds2AcsTransID":"5a0f3f00-36bd-40bb-9540-132cd97d480b",
    "tds2DsTransID":"ce20b7c2-67ea-4285-8f03-612be6eb94cf",
    "tds2ThreeDSServerTransID":"c2d2851f-1d72-47d5-a3f6-8516aba23642"
}
レスポンスパラメータ:正常系
Tds2TransResult=C&Tds2AcsReferenceNumber=3DS_AAA_BBB_NTDC_123456_98765&Tds2AcsSignedContent=eyJkdW1teSI6ImR1bW15In0=&Tds2AcsTransID=5a0f3f00-36bd-40bb-9540-132cd97d480b&Tds2DsTransID=ce20b7c2-67ea-4285-8f03-612be6eb94cf&Tds2ThreeDSServerTransID=c2d2851f-1d72-47d5-a3f6-8516aba23642

Tds2ResultApp 3DS2.0認証結果取得

3DS2.0認証の最終的な認証結果を取得します。
本APIはモバイルアプリに組み込むため、SDKをお使いの場合にご利用頂けます。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID

【取引登録】で発行された値を設定します。

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

【取引登録】で発行された値を設定します。

URL
/payment/Tds2ResultApp.json
リクエストパラメータ
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de"
}
URL
/payment/Tds2ResultApp.idPass
リクエストパラメータ
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de
レスポンス
認証結果に応じて認証フローを制御する必要があります。

・「Y:認証/口座確認に成功」または「A:処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「N:未認証/口座未確認。取引拒否」または「U:認証/口座確認を実行できなかった」、「R:認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常
Tds2TransResult tds2TransResult 半角英数1桁 固定
認証結果
  • Y:認証/口座確認に成功
  • A:処理の試行が実施された
  • N:未認証/口座未確認。取引拒否
  • U:認証/口座確認を実行できなかった
  • R:認証/口座確認が拒否された
Tds2TransResultReason tds2TransResultReason 半角英数2桁 固定
認証結果理由
  • 01:カード認証に失敗した
  • 02:不明なデバイス
  • 03:サポートされていないデバイス
  • 04:認証頻度の上限を超えた
  • 05:有効期限切れのカード
  • 06:無効なカード番号
  • 07:無効な取引
  • 08:カードのレコードが存在しない
  • 09:セキュリティ障害
  • 10:盗難カード
  • 11:不正の疑い
  • 12:カード会員に取引が許可されていない
  • 13:カード会員がサービスに登録されていない
  • 14:取引がACSでタイムアウトした
  • 15:信頼度が低い
  • 16:信頼度が中程度
  • 17:信頼度が高い
  • 18:信頼度が非常に高い
  • 19:ACSの最大チャレンジを超える
  • 20:非決済取引はサポートされていません
  • 21:3RIトランザクションはサポートされていません
  • 22:ACSの技術的な問題
  • 26:認証は試行されましたが、カード会員によって実行されませんでした
  • 80-99:DS(ディレクトリサーバ ー)の利用枠
レスポンスパラメータ:正常系
{
    "tds2TransResult":"Y",
    "tds2TransResultReason":"18"
}
レスポンスパラメータ:正常系
Tds2TransResult=Y&Tds2TransResultReason=18

SecureTran2 3DS2.0認証後決済実行

3DS2.0サービスの結果を解析し、その情報を使用してカード会社と通信を行い決済を実施して結果を返します。

リクエスト
AccessID accessID 必須 半角英数32桁 固定
取引ID
AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

URL
/payment/SecureTran2.json
リクエストパラメータ
{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de"
}
URL
/payment/SecureTran2.idPass
リクエストパラメータ
AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de
レスポンス
正常
OrderID orderID 半角英数27桁
オーダーID
Forward forward 半角英数7桁
仕向先コード
Method method 半角数字1桁
支払方法
PayTimes payTimes 半角英数2桁
支払回数
Approve approve 半角英数7桁
承認番号
TranID tranID 半角英数28桁
トランザクションID
TranDate tranDate 半角数字14桁 固定
決済日付
CheckString checkString 半角英数32桁 固定
MD5ハッシュ

出力パラメータのオーダーID、仕向け先コード、支払い方法、支払い回数、承認番号、トランザクションID、決済日付+ショップパスワードのハッシュ値を返却します。

ClientField1 clientField1 全半角100バイト
加盟店自由項目1
ClientField2 clientField2 全半角100バイト
加盟店自由項目2
ClientField3 clientField3 全半角100バイト
加盟店自由項目3
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
    "orderID":"TEST-20190628-115812",
  "forward":"2b55195",
  "method":"1",
  "payTimes":"",
  "approve":"1234567",
  "tranID":"1917900745",
  "tranDate":"20190628120831",
  "checkString":"6bff1f1547394b9fc37407dfc0d49c31",
  "clientField1":"自由欄1",
  "clientField2":"自由欄2",
  "clientField3":"自由欄3"
}
レスポンスパラメータ:正常系
OrderID=TEST-20190628-115812&Forward=2b55195&Method=1&PayTimes=&Approve=1234567&TranID=1917900745&TranDate=20190628120831&CheckString=6bff1f1547394b9fc37407dfc0d49c31&ClientField1=自由欄1&ClientField2=自由欄2&ClientField3=自由欄3
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

AlterTran 決済変更

決済が完了した取引の決済内容を変更します。

注意

3Dセキュア(本人認証サービス)を利用した取引の場合でも、再オーソリを行った取引は3Dセキュア対象外となります

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
AccessID accessID 必須 半角英数32桁 固定
取引ID
AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード
JobCd jobCd 必須
処理区分
  • CAPTURE:即時売上
  • AUTH:仮売上
  • CANCEL:キャンセル
  • SALES:実売上
Amount amount 必須 半角数字7桁
利用金額

処理区分が「キャンセル」の場合は設定不要

Tax tax 半角数字7桁
税送料

利用金額+税送料で1円~9,999,999円設定可能
税送料(日本円)を指定した場合は、利用金額+税送料を支払通貨で換算した値が支払金額となります。

Method method
支払方法

処理区分が「仮売上」「即時売上」の場合は必須

  • 1:一括
  • 2:分割
  • 3:ボーナス一括
  • 5:リボ

PayTimes payTimes 半角数字2桁
支払回数

支払方法が「分割」の場合は必須

URL
/payment/AlterTran.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "accessID":"4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "jobCd":"AUTH",
    "amount":"1000"
}
URL
/payment/AlterTran.idPass
リクエストパラメータ
ShopID=tshop99887902&ShopPass=PASSWORD&AccessID=4cfffa3f3ef6e90692dbc204e09b351b&AccessPass=c07822acefba90d95417ae37beb198de&JobCd=AUTH&Amount=1000
レスポンス
正常
AccessID accessID 半角英数32桁 固定
取引ID
AccessPass accessPass 半角英数32桁 固定
取引パスワード
Forward forward 半角英数7桁
仕向先コード
Approve approve 半角英数7桁
承認番号
TranID tranID 半角数字28桁
トランザクションID
TranDate tranDate 半角数字14桁 固定
決済日付
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
    "accessID":"4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "forward":"2b55195",
    "approve":"1234567",
    "tranID":"1917900745",
    "tranDate":"20190628120831"
}
レスポンスパラメータ:正常系
AccessID=b4e08d3cd75df2755d32b783e40bf13b&AccessPass=c07822acefba90d95417ae37beb198de&Forward=2b55195&Approve=1234567&TranID=1917900745&TranDate=20190628120831
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

ChangeTran 金額変更

決済が完了した取引に対して決済金額の変更を行います。

注意

3Dセキュア(本人認証サービス)を利用した取引の場合でも、金額変更を行った取引は3Dセキュア対象外となります

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
AccessID accessID 必須 半角英数32桁 固定
取引ID

加盟店様が取引を識別するための値

AccessPass accessPass 必須 半角英数32桁 固定
取引パスワード

加盟店様が取引を識別するための値

JobCd jobCd 必須
処理区分
  • CAPTURE:即時売上
  • AUTH:仮売上
  • SAUTH:簡易オーソリ
Amount amount 必須 半角数字7桁
利用金額
Tax tax 半角数字7桁
税送料

利用金額+税送料で1円~9,999,999円設定可能
税送料(日本円)を指定した場合は、利用金額+税送料を支払通貨で換算した値が支払金額となります。

URL
/payment/ChangeTran.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "accessID":"4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "jobCd":"AUTH",
    "amount":"1000"
}
URL
/payment/ChangeTran.idPass
リクエストパラメータ
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=4cfffa3f3ef6e90692dbc204e09b351b&AccessPass=c07822acefba90d95417ae37beb198de&JobCd=AUTH&Amount=1000
レスポンス
正常
AccessID accessID 半角英数32桁 固定
取引ID
AccessPass accessPass 半角英数32桁 固定
取引パスワード
Forward forward 半角英数7桁
仕向先コード
Approve approve 半角英数7桁
承認番号
TranID tranID 半角英数28桁
トランザクションID
TranDate tranDate 半角数字14桁 固定
決済日付
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
    "accessID":"a6a6b0061347e90cdef806b39bd28705",
    "accessPass":"5e0e54b892e14ed03e8cf807a6053813",
    "forward":"2b55195",
    "approve":"1234567",
    "tranID":"1917900745",
    "tranDate":"20190628120831"
}
レスポンスパラメータ:正常系
AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&Forward=2b55195&Approve=1234567&TranID=1917900745&TranDate=20190628120831
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001

SearchTrade 取引状態参照

指定したオーダーIDの取引情報を取得します。
通信障害でタイムアウトが発生する等の状況で決済結果が取得できなかった場合は、本インタフェースにて取得してください。

リクエスト
ShopID shopID 必須 半角英数13桁
ショップID
ShopPass shopPass 必須 半角英数64桁
ショップパスワード
OrderID orderID 必須 半角英数記号27桁
オーダーID

加盟店様が取引を識別するための値

UseSiteMaskLevel useSiteMaskLevel
サイト設定のマスクレベル利用有無
  • 0:利用しない(デフォルト)
  • 1:利用する
UseFloatingMask useFloatingMask
可変マスク利用有無
  • 0:可変マスクを利用しない(デフォルト)
  • 1:可変マスクを利用する

URL
/payment/SearchTrade.json
リクエストパラメータ
{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "orderID":"ORDER0000001",
    "useSiteMaskLevel":"0"
}
URL
/payment/SearchTrade.idPass
リクエストパラメータ
ShopID=tshop99887902&ShopPass=PASSWORD&OrderID=TEST-20190628-115812&UseSiteMaskLevel=0
レスポンス
正常
OrderID orderID 半角英数27桁
オーダーID
Status status 半角英字15桁
現状態
ProcessDate processDate 半角数字14桁 固定
処理日時
JobCd jobCd 半角英字10桁
処理区分
AccessID accessID 半角英数32桁 固定
取引ID
AccessPass accessPass 半角英数32桁 固定
取引パスワード
ItemCode itemCode 半角英数7桁
商品コード
Amount amount 半角数字7桁
利用金額
Tax tax 半角数字7桁
税送料
SiteID siteID 半角英数13桁
サイトID
MemberID memberID 半角英数60桁
会員ID
CardNo cardNo 半角数字16桁
カード番号
Expire expire 半角数字4桁
有効期限
Method method 半角数字1桁
支払方法
PayTimes payTimes 半角数字2桁
支払回数
Forward forward 半角英数7桁
仕向先コード
TranID tranID 半角英数28桁
トランザクションID
Approve approve 半角英数7桁
承認番号
ClientField1 clientField1 全半角100バイト
加盟店自由項目1
ClientField2 clientField2 全半角100バイト
加盟店自由項目2
ClientField3 clientField3 全半角100バイト
加盟店自由項目3
異常
ErrCode errCode 半角英数3桁 固定
エラーコード
ErrInfo errInfo 半角英数9桁 固定
エラー詳細コード
レスポンスパラメータ:正常系
{
  "orderID":"2019062701",
  "status":"AUTH",
  "processDate":"20190213200436",
  "jobCd":"AUTH",
  "accessID":"67ed6da3551771c9f592cd6f7a19a90c",
  "accessPass":"0695cc5eb676f9e11ab6e432f3747941",
  "itemCode":"abc1234",
  "amount":"10000",
  "tax":"1000",
  "siteID":"",
  "memberID":"",
  "cardNo":"************9999",
  "expire":"2203",
  "method":"1",
  "payTimes":"",
  "forward":"2SF37F6",
  "tranID":"1917900745",
  "approve":"123456a",
  "clientField1":"",
  "clientField2":"",
  "clientField3":""
}
レスポンスパラメータ:正常系
OrderID=2019062701&Status=AUTH&ProcessDate=20190213200436&JobCd=AUTH&AccessID=67ed6da3551771c9f592cd6f7a19a90c&AccessPass=0695cc5eb676f9e11ab6e432f3747941&ItemCode=abc1234&Amount=10000&Tax=1000&SiteID=&MemberID=&CardNo=************9999&Expire=2203&Method=1&PayTimes=&Forward=2SF37F6&TranID=1917900745&Approve=123456a&ClientField1=&ClientField2=&ClientField3=
レスポンスパラメータ:異常系
[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]
レスポンスパラメータ:異常系
ErrCode=E01&ErrInfo=E01040001